Multiwii GPS Airplane

                     updated 2014-04-04

Download the latest Version of FixedWing Nav code

This is a addon to the

How to setup a Multiwii Airplane

And Starts from a trimmed MWii Plane

What to expect from a MWii GPS plane?

The code supports.RTH & GPS-Hold.With the simplest FlightController and a Gps. Perfect for exploring the surroundings with your FPV plane.

A good presentation of RTH mode borrowed from Spencer Trejo

Connection Diagram

GPS-Hold

Can be only enabled With AUX switch.
Check Angle mode and Hold in Gui.
When GPS-Hold is activated The position where it was activated  is saved in a 3D Waypoint.
The plane will Navigate and try to "hit" the WP continuously and maintaining altitude.
No pattern is programmed and the plane fly the shortest way back.

RTH (Return to home)

Can be enabled With AUX switch or by Failsafe.
Check Angle mode and RTH in Gui.

When RTH is activated the plane will start Climb to reach safe Altitude.
If RTH is enabled Higher than set altitude it will start navigation and keep that altitude.
If altitude is safe the plane will start to Navigate to home Position.

Only use Angle/Horizon + Gps Home/Hold together.
Do NOT Activate BARO Or MAG for navigation.
It will interfere with the navigation code.

When the plane reaches SAFE_DECSCEND_ZONE the plane will begin descending to correct altitude.
The plane will keep flying in hold mode and continuously pass home.

If Failsafe is active at return The plane will Disarm motor and descending to a "Landing"

PID settings is made in Gui.
ALT & NavR.

Return Altitude can be set with
PosR D-parameter.
Scale is in km...
50m is set as defaut.
250m is Max.

=====================================================

This settings is done  in  Config.h .

=====================================================

#define MAXTHROTTLE 2000 
Because you  want Full Power sometimes!
Mwii uses 1850 for MultiCopters.

Select your GpsType

In My case

#define GPS_PROMINI_SERIAL    115200

#define NMEA

Or 

#define I2C_GPS

Failsafe function

#define FAILSAFE
The obvious reason to have GPS in a plane!
FAILSAFE take over the plane and fly it to Launch point if the Radio is lost.
When Home is reached the plane will stop motor and attempt to make a "Landing"

If Transmitter sends commands below 980µs Mwii will enable Failsafe!

Angle and GPS_HOME become activated.

If you can program failsafe function
on your Receiver Program throttle
To Below 980µs
Or set the switches for RTH.

Safety settings...

#define MOTORSTOP
Give you the chance to Cut motor off with the Throttle Stick.
If Throttle is lowered to zero motor will stop.
Nice when doing preflight checks

Warning...
If you stop motor during Navigation the plane Will most likely Stall!
(Common Aviation Physics...)

=====================================================

This settings is temporarily  in  Gps.h .

=====================================================
The following settings controls the behaviour of the plane during Navigation.
Default settings gives quite soft characteristic.

This values can be set to Zero if Ex Rudder is not used.
#define GPS_MAXCORR    15  // Degrees banking Allowed by GPS.
#define GPS_RUDDER        15  // Maximum Rudder

#define GPS_MAXCLIMB   15     // Max allowed Degrees climbing . To much can stall the plane.
#define GPS_MAXDIVE      15     // Diving . To much can overspeed the plane.

You might need to make some changes to the throttleSettings.
ThrottleSettings in GPS modes

#define CRUICETHROTTLE    1600
The vale  Throttle keeps when Altitude is correct for "Long Distance".
Should be set to a comfortable speed well over Stall Speed.

#define IDLE_THROTTLE      1300
When the plane is descending this is the lowest allowed Throttle.

#define SAFE_NAV_ALT        20  // Meters
To avoid  trees & buildings etc The plane will make a climb straight forward before Navigation starts.

#define SAFE_DECSCEND_ZONE  50 // Meters
 Radius around home where descending is OK

Note!...Don't forget the pre launch check!...

After takeoff do a RTH to ensure Home is set correctly
before Going on a FPV mission

Odd behavior on Rudder

Rudder have a tendency to try to hold the heading during Aileron/Elevator turns.

It can make the plane fly Sideways and other strange phenomena.
The cure is to Set YAW_I = Zero.

=====================================================

A example for a simple setup for RTH

FlightController  $27  Or  NanoWii     $20
Or if you have a DSM2 transmitter AIO FC $28

GPS module     $18

A complete AutoPilot capable to save your plane  under 50$

=====================================================